C/C++ 3D Game Tools

home *** CD-ROM | disk | FTP | other *** search

/ C/C++ 3D Game Tools / C-C++ 3D Game Tools.iso / ziptools / arj / zface72.arj / ZFMANUAL.DOC < prev next >

Wrap

Text File | 1993-06-05 | 21.9 KB | 642 lines

ZFace The easy way to use file archiving programs. Version .72 Revised June 5, 1993 _______ ____|__ | (tm) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER Copyright 1991 by Stanley N. May All rights reserved ───────────────────────────────────────────────────────────────── DISCLAIMER Users of ZFace must accept this disclaimer of warranty: "ZFace is supplied as is. ZFace carries NO warranty either express or implied. The person using ZFace bears all risk as to the quality and performance of the software. The author assumes no liability for damages, direct or consequential, which may result from the use of ZFace." ───────────────────────────────────────────────────────────────── TABLE of CONTENTS Definition of Shareware....................................1 License and Agreement......................................2 Ombudsman Statement........................................3 Support....................................................3 Introduction...............................................4 Requirements...............................................5 Getting Started............................................5 Drive and Directory Selection..............................6 File List Windows..........................................6 Zip........................................................6 Unzip......................................................8 View and Zip─to─EXE........................................9 Results....................................................9 Registration Form.........................................10 ───────────────────────────────────────────────────────────────── DEFINITION OF SHAREWARE Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details ── some request registration while others require it, some specify a maximum trial period. ZFace requires registration within 30 days of first use. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money─back guarantee ── if you don't use the product, you don't pay for it. - 1 - ───────────────────────────────────────────────────────────────── LICENSE AND AGREEMENT ZFace is a "shareware program" and is provided at no charge to the user for evaluation. You may copy and distribute the program to whoever you wish provided that the disk or archive file containing ZFace contains all the files and nothing but the files. To distribute a copy of ZFace as part of a compilation or with some other software package or text file, you must first contact the author at the address or phone numbers listed below for permission. The essence of "user─supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using ZFace after a 30 day trial period, you must make a registration payment of $25.00. A registration form can be found at the end of this manual. The $25.00 registration fee will license one copy for use on any one computer at any one time. You must treat the registered version of this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Site licenses and other multiuser arrangements may be made by contacting the author. Users of ZFace must register and pay for their copies of the program within 30 days of first use or their license to use ZFace is withdrawn. When you register ZFace you will receive: * Notification of upgrades * Unlimited technical support * Acknowledgment and Thanks for your support and encouragement. Anyone distributing ZFace for any kind of remuneration must first contact the author at the address below for authorization. This authorization will be automatically granted to ASP approved vendors. However, the author must still be advised so that the distributor can be kept up─to─date with the latest version of ZFace. - 2 - ───────────────────────────────────────────────────────────────── OMBUDSMAN STATEMENT "This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware─related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536." ───────────────────────────────────────────────────────────────── SUPPORT If you need any kind of assistance with ZFace, please contact: Stan May 916B Kirsten Court Rohnert Park, CA 94928 Voice:....................(707) 585-1728 Compuserve User ID:.......72740,2076 I'd love to hear any comments or suggestions you might have. - 3 - ───────────────────────────────────────────────────────────────── INTRODUCTION File archiving programs, like PKZIP, are handy utilities for condensing many files into one much smaller file. This makes it fast and easy to transfer files among different users either on floppy disks or via modems. It's easy because you only have to deal with one file. It's fast because one smaller file will take less time to upload or download over a modem. But there is a downside... PKZIP and other file archiving programs are command line based. That means, in order to use them, you must remember and type in long commands and switches at the C:> prompt. If you want to archive more than one file, you have to remember all the file names or create a list of files the archiving program can use. With so much software that is menu based, many users don't need or want to learn long, typed commands and switches or create extra file lists. A need for a menu based interface for archiving programs is indicated. This is where ZFace comes in. ZFace was created as an MENU driven interface for command line based archiving programs. ZFace is simple to use, you just tell ZFace what you want to do by selecting an action from a menu, then tell it what files to work on by selecting them from a list. ZFace does the rest. File archiving programs, like PKZIP, usually have a myriad of options. These options may be needed by some users but many people only need to Zip, View and Unzip files. At this time only PKZIP is supported. Other programs will be supported in a future release. ZFace supports the following PKZIP options: Zip Create a new .zip file. Update existing .zip file with a newer version of a file. Add files to an existing .zip file. Zip directories View View contents of .zip file. Unzip Unzip all files in a .zip file. Unzip selected files in a .zip file. Restore zipped directories. Zip─to─EXE * Create a self extracting Zip file. * Zip─to─EXE is a PKZIP program (zip2exe.exe) that allows you to convert an existing .zip file into a self─extracting .exe file. The self─extracting file can be unzipped at the command line simply by typing its name and pressing <ENTER>. The PKZIP program is NOT required. That makes it easy to give a zipped file to anyone, whether they have a copy of PKZIP or not. - 4 - ───────────────────────────────────────────────────────────────── REQUIREMENTS *** Users must supply their own copy of PKZIP Ver 1.10 or later *** ZFACE.EXE, pkzip.exe, pkunzip.exe and zip2exe.exe must reside in the same directory. ───────────────────────────────────────────────────────────────── GETTING STARTED ZFace will present the user with a main menu bar consisting of Zip, View, Unzip, Zip─to─EXE and Quit. The program will then guide the user through selecting a drive and directory, selecting files to work on and executing the selected option. All subdirectories, files and options will be selected from a list, menu style. After executing the PKZIP option, the program will return to the main menu. Files can be zipped or unzipped from any drive or directory and the resulting files will be placed in the same directory. Some temporary files will also be created. They will be erased after the option has been executed. At the command line, type "zface" and press <ENTER>. The main program screen will come up. Choose a menu item by using the arrow keys and press <ENTER>. Follow on─screen directions using the highlighted Action Keys. Generally: Action Keys are GREEN on color screens and BOLD on mono screens. a. Press <ENTER> after inputs, for menu selections and to mark and unmark files. b. Press <ESC> to cancel or backup. Pressing it several times will take you back to the main menu. c. Press <TAB> to go between the directory window and the file list window. d. Press <F10> to execute an action. e. <PageUp>, <PageDown> and the arrow keys work as expected. Mouse: Only the left button is used. a. Click on a menu item to execute it. b. Click on Action Keys. c. Click on sub─directories and files to select or mark/unmark. d. Click anywhere when you get "Press any key..." - 5 - ───────────────────────────────────────────────────────────────── DRIVE and DIRECTORY SELECTION In the drive selection window, enter the drive letter: A, C, D etc and press <ENTER>. ZFace is not case sensitive and no colon is needed. The current path will be displayed and two windows will pop up. One window will list sub─directories to choose from. The other window lists the files in the current path. Use the <UP/DOWN> arrow keys or <PAGEUP/PAGEDOWN> to navigate through the directory list. Press <ENTER> to select a directory. Press <TAB> to go to the file list window. Mouse: Click on a directory to select it. Click on an Action Key. Clicking anywhere in the file list window is the same as pressing <TAB>. ───────────────────────────────────────────────────────────────── FILE LIST WINDOWS The file list window is used to select the file or files to work on. If ZIP was selected, then all files in the working directory will be listed. For UNZIP, VIEW and Zip─to─EXE, only files with a .zip extension will be listed. Use the <UP/DOWN> arrow keys or <PAGEUP/PAGEDOWN> to navigate through the file list. Press <ENTER> to select or mark/unmark files. Mouse: Click on an Action Key. Click on a file to select or mark/unmark. ───────────────────────────────────────────────────────────────── ZIP Selecting files to zip You can either ZIP all files in a directory or you can select only specific files. All files: Press <INSERT> to mark all files. Press <DELETE> to unmark all files. Specific files: Press <ENTER> to mark or unmark individual files. Mouse: Click on an Action Key. Click on a file to mark or unmark. - 6 - ZIP the files After selecting your files press <F10> to ZIP the marked files. An option menu will be displayed. Use the <UP/DOWN> arrow keys and press <ENTER> to select an option. Mouse: Click on the <F10> Action Key. Click on an option. Options Create ZIP the marked files and place them in a new .zip file. Add Place the marked files in an existing .zip file and overwrite any files with the same name. Update Place the marked files in an existing .zip file. Overwrite only if file is dated later than a file with the same name already in the .zip file. Include sub─directories All files in the working directory plus all files in all sub─directories of the working directory will be zipped. The files in the sub─directories include their pathnames so the same directory structure can be restored when the file is unzipped. This option will create a new file. Quit to main menu. "Cancel ZIP, I want to do something else." Filename After selecting an option you will be prompted for a file name. Create a new file Type in a file name and press <ENTER>. The .zip extension will be added by the program. Pressing <ENTER> with no file name or pressing <ESC> cancels ZIP and returns to the main menu. Updating or adding to existing file A window will pop up with a list of .zip files in the working directory. Press <ENTER> to select a file. Press <F10> to update the selected file Any other key lets you select another file. Mouse: Click on a file to select it. Click on the <F10> Action Key. Clicking anywhere else lets you select another file. If there are no .zip files in the working directory, you will get the same file name window as in Create a new file above. PKZIP is executed and you will see your files being zipped! - 7 - ───────────────────────────────────────────────────────────────── UNZIP Press <ENTER> to select a file to unzip. Press <F10> to UNZIP. Any other key lets you select another file. Mouse: Click on a file to select it. Click on the <F10> Action Key. Clicking anywhere else lets you select another file. Next you will be asked which unzip option to use. Use the arrow keys and press <ENTER> to select an option. Unzip ALL files to the working directory. Place ALL files in the working directory, even if the .zip file includes pathnames and a directory structure. SELECT individual files. Allows you to select only specific files to unzip. Restore a DIRECTORY structure. Place all files WITHOUT a pathname in the working directory and the rest will be put in the proper sub─directory under the working directory. Sub─directories will be created under the working directory if they don't already exist. ** CAUTION ** Make sure your .zip file is where you want it before you unzip it. Mouse: Click on a menu item. Unzip all & restore directory Done, watch 'em unzip! Selecting individual files Press <ENTER> to mark and unmark files. Press <F10> to unzip the marked files. Mouse: Click on a file to mark or unmark. Click on an Action Key. Your files get unzipped! - 8 - ───────────────────────────────────────────────────────────────── VIEW and Zip─to─EXE Press <ENTER> to select a file. Press <F10> to execute the action. Any other key lets you select another file. Mouse: Click on a file to select it. Click on the <F10> Action Key. Clicking anywhere else lets you select another file. The action is executed while you watch! ───────────────────────────────────────────────────────────────── RESULTS All files resulting from the action taken will be saved to the "working" directory. The working directory is the directory containing the files you are "working" on. ZIP example: Working directory.........c:\lotus\spread Zip file name.............123sprd Will result in............c:\lotus\spread\123sprd.zip UNZIP example: Working directory.........c:\lotus\spread Unzip.....................c:\lotus\spread\123sprd.zip Will result in............c:\lotus\spread\*.* (all files) Restore Directory Structure example: Working directory.........c:\lotus Unzip.....................c:\lotus\123sprd.zip Containing..............*.* spread1/*.* spread2/*.* Will result in............c:\lotus\*.* ..........................c:\lotus\spread1\*.* ..........................c:\lotus\spread2\*.* - 9 - ───────────────────────────────────────────────────────────────── REGISTRATION FORM Mail your check along with this form to: Stanley May 916B Kirsten Court Rohnert Park, CA 94928 Company: ─────────────────────────────────────── Name: ─────────────────────────────────────── Address: ─────────────────────────────────────── ─────────────────────────────────────── City: State: Zip: ────────────────── ──── ──────── Phone: ( ) ─ ───── ────── ───────── ZFace version you are currently using: ────── Number of copies @ $25.00 ea........$ . ─── ────────── ───── All funds must be in US Dollars, personal and company checks accepted. All checks must be drawn against a US Bank and payable in US Dollars. Sorry, no credit cards. ───────────────────────────────────────────────────────────────── <END> - 10 -